你可以请求一个新的 balance_bonus
对象向用户发起一次余额赠送。赠送成功后,用户的可用余额会增加,赠送的余额不能提现、转账,只能用于消费。
属性 | 描述 |
---|---|
id string | 余额赠送对象 ID,由 Ping++ 生成。 |
object string | 值为 "balance_bonus"。 |
app string | 对应 app 对象的 id ,查看 如何获取App ID。 |
created int | 创建时间,用 Unix 时间戳表示。 |
livemode timestamp | 是否是 live 模式。 |
paid boolean | 是否已赠送。 |
refunded boolean | 是否存在退款信息,无论退款是否成功。 |
order_no string | 商户订单号,必须在商户的系统内唯一。 |
amount int | 赠送金额,单位为分。 |
amount_refunded int | 已退款的赠送金额,单位为分。 |
time_paid int | 支付成功时间,用 Unix 时间戳表示。 |
user string | 受赠的 user 对象的 id 。 |
balance_transaction string | 关联的 balance_transaction 对象的 id 。 |
description string | 附加说明,最多 60 个 Unicode 字符。 |
metadata hash | 详见 元数据。 |